home *** CD-ROM | disk | FTP | other *** search
/ Aminet 16 / Aminet 16 (1996)(GTI - Schatztruhe)[!][Dec 1996].iso / Aminet / util / pack / UnSquish.lha / UnSquish / UnSquish.doc < prev    next >
Text File  |  1996-10-05  |  6KB  |  156 lines
  1.  
  2. UnSquish version 1.0, by Steffan in 1996
  3. ========================================
  4.  
  5.  
  6. 1. What is UnSquish?
  7. ¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
  8. An Intuition interface to the XFD library.
  9. In plain English, this means  that  UnSquish  is a virtually universal
  10. decompresser.  It will unpack most packed files (but not archives).
  11.  
  12.  
  13. 2. Installing UnSquish
  14. ¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
  15. Drag the icon to whereever on hard- or floppy-disk you want to install
  16. it.   You  must  also  have  xfdmaster.library  version  37  or  above
  17. installed in  LIBS:.  If  you  don't have a  suitable version, one  is
  18. supplied in the UnSquish/libs/ directory.  Just copy it into LIBS:.
  19.  
  20.  
  21. 3. Using UnSquish
  22. ¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
  23.  
  24. A. From Workbench
  25.  
  26. Double-click on  UnSquish's icon.   The program will  open  its status
  27. window, and  put up a standard ASL file selector.  Choose the file you
  28. want to decompress.  UnSquish will load it; if it is a  crunched file,
  29. you will be asked to confirm that you want to decrunch.  If you choose
  30. to  do so, the file will  be decompressed,  and the file selector will
  31. re-open so you can save the file.  You can abort the save by canceling
  32. the file  selector.   Once the file has  been saved/canceled, you have
  33. the option of loading and decompressing another file.
  34.  
  35. In  the  event that  decrunching  fails,  due  to corrupted  data  for
  36. example, UnSquish will inform  you of the failure.  You will then have
  37. the chance to load another file, or quit.
  38.  
  39. If you click once on UnSquish's icon, hold Shift,  and double-click on
  40. another file's icon, UnSquish will load that file instead of initially
  41. putting up the file selector.  Alternatively, if you are using AmigaOS
  42. version  3 or above, you can  drag an icon  into the file selector  (I
  43. don't think this works under AmigaOS 2 but I may be wrong).
  44.  
  45. B. From Shell
  46.  
  47. Synopsis: UnSquish [file]
  48.  
  49. If "file" is specified, UnSquish will load that  file  and  attempt to
  50. decompress it.  If "file" is not specified, UnSquish will use the file
  51. selector.
  52.  
  53. Other than  that,  UnSquish behaves identically from Shell as  it does
  54. from Workbench.
  55.  
  56.  
  57. 4. Bugs and limitations
  58. ¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
  59. No known bugs (now watch someone prove me wrong :-)
  60.  
  61. UnSquish  can't  cope  with  encrypted  files,  eg those  produced  by
  62. PowerPacker  with its encrypt option,  or by some  XPK encrypters.  It
  63. will try to decompress, but  will  fail with a "wrong password" error.
  64. A password entry facility will be included in the next release.
  65.  
  66. Executables  that  have  been  packed  by  some  "dirty"  packers  get
  67. irrevocably  altered  by  them.   Whilst  UnSquish  will  unpack   the
  68. programs,   they  will   not   work   in   their  decompressed  state.
  69. Fortunately, not many  people use this kind of  packer any more.   The
  70. two most common Amiga packers (PowerPacker and Imploder) are perfectly
  71. safe.
  72.  
  73. People  who  have been using xfdmaster.library for some time will know
  74. that extra  decrunch modules (called "slaves") are  available  for it.
  75. UnSquish does not support these slaves.  This should  not present much
  76. of  a  problem,  as  all  the  common   decrunchers  are  included  in
  77. xfdmaster.library.  Only a few obscure ones exist as slaves.
  78.  
  79. UnSquish requires AmigaOS release 2.00 (Exec version 36) to run.  This
  80. is only a limitation if you have AmigaOS release 1.3.3 or below...
  81.  
  82.  
  83. 5. About packers
  84. ¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
  85. File packers are great.  However, some are more efficient than others.
  86. As an example, take the old packer "Turbo Squeezer".  Whilst  it packs
  87. pretty well, newer packers  (such as my  favourite, Imploder) are more
  88. efficient, both in  terms  of file  size and speed.  However, Imploder
  89. has no option to  decrunch  files packed with old  packers.   This  is
  90. where programs like  UnSquish come  in.   Armed with UnSquish, you can
  91. decompress  programs compressed  with  old packers,  and recrunch them
  92. with Imploder  (no, the authors  of Imploder (Peter Struijk and Albert
  93. Brouwer) are *not* paying me commission! :-)
  94.  
  95. Imploder does not support data files, only  executables.   For data, I
  96. recommend  the  XPK system.   If you have xpkmaster.library installed,
  97. XFD (and hence UnSquish) will  decompress files compressed with any of
  98. the XPK slaves that you also have installed.
  99.  
  100. Isn't is confusing that XPK and XFD look so similar :-)
  101.  
  102. Never use  dirty  "absolute  address"  packers.  It  is impossible  to
  103. decrunch them properly.  Programs  like xfdDecrunch (by Georg Hörmann)
  104. can *sort-of*  get them  decrunched  and working.  But it  isn't easy;
  105. UnSquish doesn't even try.
  106.  
  107.  
  108. 6. History
  109. ----------
  110. - UnSquish v0.1 (21-Aug-96, internal beta release only)
  111. · First release.
  112.  
  113. - UnSquish v1.0 (25-Sep-96, first public release)
  114. · Small bug in window drawing code fixed.
  115. · Now requires xfdmaster v37+ (previously required v36+).
  116.  
  117.  
  118. 7. Plans for the future
  119. ¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
  120. Add password entry facility for encrypted files.
  121. Write a version that's okay under AmigaOS 1.2/1.3x (will be short of
  122. quite a few features though), if there is demand for one.
  123.  
  124.  
  125. 8. Legal stuff
  126. ¯¯¯¯¯¯¯¯¯¯¯¯¯¯
  127. xfdmaster.library is copyright ©1996 by Georg Hörmann.
  128.  
  129. UnSquish is copyright ©1996 by Stephen Williams (no, Steffan is not my
  130. real name :-).
  131.  
  132. UnSquish is  freeware.   It may  be  uploaded  to bulletin boards  and
  133. distributed by  PD libraries, provided  only  a nominal charge is made
  134. for distribution.
  135.  
  136. UnSquish may  be  included  on magazine cover disks.   If you wish  to
  137. include UnSquish on a cover disk, please write and let me know.
  138.  
  139. UnSquish  may  not be included  in any commercial package without  the
  140. permission of the author.
  141.  
  142. UnSquish is not in the public  domain.  It may  not be modified in any
  143. way.  No-one may make any profit from UnSquish.
  144.  
  145.  
  146. 9. How to contact the author
  147. ¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
  148. Throw snail-mail at:
  149.  
  150. Stephen Williams,
  151. 9, Helmsley Way,
  152. Spalding,
  153. Lincolnshire,
  154. PE12 6BG,
  155. England.
  156.